Tag attributes Text 



Description 





<cii> 




i 

1 


Contains zero or more modes 




<mode> 


name 


I 


Coniams zero or more command 
tags. Attribute is required. j 




' <command> 




1 i 
i Contains a required keyword Eas. 

L... 




<keyword> 


text 




Contams zero or more keyword 
tags, wuh an optional action or 
help tag. Attnbute is required. 




<help> 




Yes 


May be embedded tn keyword 
or arg elements. 




<action> 


object 
method 




Contains zero or more arg tags. 
The attnbutes are required. 




<arg> 






Contains a single instance of type 
tag, may contain a help tag. 




<iype> 


Type 




Empty tag, Attnbute is required, 
must be a valid java type. 



FIGURE 1 



']4 1? *S 1:9 JTC Tnu May 6 l}9j 
Ti.-ne source :3 user conf :cura : lor. 



version^ " 1 . G " encoding = " 'JS- ASCI I " > 
OOCTYPE cli SYSTEM ''cii.dcd"> 

mode name= "global " > 

command> 

<keyword cext = " show''> 

<help>Show running syscem information</help> 
... <'-iots of other show keywords... 

<keyword text5'*clock*'> 

<?help>display the syscem clock</help> 

<action ob^ects^Clock" methods * show* > " 

</action> 



<keyword t:ext = 'detail''> 

<help>Display detailed information </help> 
action ob^ects'Clock' methods' showDe tail " > 
</action> I 



</keyword> 
</keyword> 




ZK 



</keyword> 
</command> 
</mode> 

</Cli> 
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Command 



Command - :-:c< se. 

Za . : : ~."e -cr - - 
''C^.'TH ^'cr. zt /8ar 

Conmand > z.zc< sec 10 20 :: :5 Sec 

<1993-l-:5> -ear 



Cotmtiand > cloc< sec 00.00 30 25 Sep 
CoTRmand > 



<cofTiinand> — ^ 
<kev^ord cexc = " clociC > 

<heIp>Manage che Syscem c]ock</heip> 
<ke/word cext^" sec 

<h€lp> Set che cime and date</help> -r^a 
<action ob^ects'CIock' methods " sec ^^-O-* 7 
<arg> <!-time argument 

<type type*" Java . land . String* ></ c^/pe> -zi^ 
<help>hh:mni: ss Current Time </heip> ^^O^o 
</arg> 

<arg> <!-day of the month argument 

<type typea'java. lang. Integer^x/ C'/pe> ^ 
<help>&lC; l-31&gt ; Day of the monch< / heip>'-^^ v ?5 
</arg> 

<arg> <i-day of the month argument --> 

<type type-' ]ava . lang . Integer" ></ cype> 
<help>MONTH Month of the year <^heLp>'^fo 

</arg> 

<arg> <'. -year argument - - > 

<type types' Java, lang . Integer" ></ cype> 
<help>< 1993-2035> Year</help> ^0T5 
</arg> 
</action> 
< / i<eyword> 
< / keyvord> 
< /command* 
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<?xml version='1.0' encoding= us-ascn"'> 
<!— DTD for the di description file --> 

<l — The cii tag is the topmost element. Contams zero or more modes -> 
<!ELEMENT cli (mode*)> 

<I--The mode tag contains zero or more command tags. The mode must 
have a name, for example "global", "exec", "config" -> 

<IELEMENT mode (conimanci*)> 

<!ATTLIST mode 

name CDATA #REQUIRED 

> 

<! — The command tag contains a single keyword ~> 
<!ELEMENT command (keyword)> 

<!-The keyword tag contaii^s zero or more subkeywords, with an optional 

single instance of action or help. The single attribute is the keyword test 

which must be present -> 
<!ELEMENT keyword ((keyword)*, achon?, help?)> 
<!ATTLIST keyword 

test CDATA #REQUIRED 

> 

<!- The action tag contains zero or more argument tags. The "object" 
and "method" attributes must be present and defined" 
<! ELEMENT action (arg*)> 
<!ATTLIST action 

object CDATA #REQUIRED 

method CDATA #REQUIRED 

> 

<!~ The arg tag contains a single instance of a type tag and an 
optional help tag -> 
<!ELEMENT arg (type, help?)> 

<!- The type tag is an empty tag with a required attribute "type". The 

value of the attribute should be a Java class name -> 
<!ELEMENT type EMPTY> 
<!ATTLIST arg 

type CDATA #REQUIRED 

> 



<! - The help tag enloses some text ~> 
<!ELEMENT help (#PCDATA)> 
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Command Kev word Set 



-how date I { -.ho^^ ' 'date [ 

-hvi\v d.itt; detail | ! "Nhow " date', 'detaii'*} -^""v^ iZ/O 

-l^^^'i^ ^et I l"Jock" -set "I i 
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Argument 
Number 


Argument Description 


Argument Help 


I 


Time in 00 00:00 format 


hh:mm:ss Current Time 




day of the month in integer 
tormat 


<I-31> Day of the month 


3 


month m three letter 
format 


MONTH Month of the Year 


4 


Year m integer format 


<1993-2035> Year 
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Command 
Keyword Sequence 


Help 


show 


Show running system Infonnacion 


clock 


Manage the system clock 


>.htiw clock 


Display the system clock 


shc>w citKk detail 


Display detailed mformacion 


clock set 


Set the time and date 
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r 




r 


Argument Number 


Argument Description 


Java Tvpe 


I 


Time tn 00 00 00 tormat 


:ava .ar.g 5"r.r.q ^ 




dav or month mteaer rormat 


:ava .ang rr.teger 




Month in three letter format 


;a-/a lar.g Smr.g 




Year m integer format 


: ava . lang . Inceger 
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<?xml version='1.0 encoding= 'US- ASCII' ?> 
<! DOCTYPE cU SYSTEM "cU.dtd"> 
<cli> 

<mode name="exec"> 



<cominand> 

<keyword text="show"> 

<help>Show running system infonnation</heip> 
.... <!-lots of other show keywords... -> 

<ke3Avord text="clock'> 
</help>Display the system clock </help> 
<action object= "Clock" method= "show"> 
</action> 



<keyword text="detail"> 
<help>Display detailed information</help> 
action object="Clock" method="showDetail" 
</action> 
</keyword> 
</keyword> 
</command> 
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<cominand> 

<keyword text= "clock" 
<help>Manage the System clock</help> 

<keyword test="set"> 

<heip> Set the time and date</help> 

<action object= "Clock" method="set"> 

<arg><!~ time argument -> 

<type type="Java.land.String"></type> 

<help>hh:mm:ss Current time</help> 

</arg> 



<arg> <! -- day of the month argimient ~> 
<type type="Java.land.Integer"></type> 
<help><l-31> day of the month</help> 
</arg> 

<arg> <! ~ day of the month argument -> 
<type type="Java.land.Integer"></type> 
<help>MONTH Month of the year</help> 
</arg> 

<arg> <! - year argument -> 

<type type='7ava.land.Integer"></type> 

<help>&:lt;1993-2035> Year</help> 

</arg> 

</action> 
</keyword> 
</keyword> 
</command> 
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public void show () { 

SimpleDateFormat formatter = 

new SimapleDateFormat ("hh:mm:ss.SSS zzz EEE 
MMM dd yyyy"); 

System.out.printlnC'*" + formatter.format 
(new DateO)); 
} 

public void showDetail () { 

this.show(); 

if (Clock.source()) 

System.out.println ('Time source is user 
configuration"); 

else 

System.out.println ("No time source"); 

} 
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public void set (String time, Integer day, String month, Integer year) 

throws lOException, InterruptedException, CLIArgumentException 

( 

/ / Validate the arguments 
SimpleDateFormat format = new SimpleDateFormat ("hh;mm;ss); 
format.setLenient (false); 
try { format parse (time) 
I catch (ParseException e) { 

throw new ArgumentException (1); 

} 

if (day.intValue() < 1 | | day.intValue() > 31) 
throw new ArgumentException (2); 

format.applyPattem ("MMM"); 
try { format.parse(month); 
} catch (ParseException e) { 

throw new ArgumentException (3); 

} 

if (year.intValue() < 1993 | | year.intValue () > 2035 
throw new ArgumentException (4); 

/ / One last check for day, month and year validity (e.g., Feb 31) 
format.applyPattem ("dd MMM yyy"); 
try { format.parse(day.toString() + month + year.toStringO); 
} catch (parseException e) { 

CLIEngine.out.printlnC'Invalid date (doesn't exist)"); 

Return; 

} 

/ / Do the actual work 
String [1 cmd = {"/bin/date", "-s'', time + + day + " + month + " + 
}; 

Process proc = Runtime.getRuntime().exec (cmd); 

proc.waitFor(); 

if (procexitValueQ > 0) { 

CLIEngine.err.println( ''Operation not permitted"); 
return; 

} 

clock.soxirceSetO; 

I FIGURE 20 



